home *** CD-ROM | disk | FTP | other *** search
/ Scene Storm / Scene Storm - Volume 1.iso / coding / c / localloginpw / readme < prev    next >
Text File  |  1995-11-05  |  6KB  |  153 lines
  1. *****************************************************************************
  2. *                                                                           *
  3. *                    PUBLIC DOMAIN SOFTWARE LICENSE                         *
  4. *                                                                           *
  5. * The following program(s) and/or data file(s) are declared Public Domain.  *
  6. *                                                                           *
  7. * Provided the end user sticks to the following author's wishes, he or she  *
  8. * is authorized to use, copy, analyze and improve the items.                *
  9. *                                                                           *
  10. * Conditions of use:                                                        *
  11. * ------------------                                                        *
  12. *                                                                           *
  13. * 1) No part of this distribution will be omitted (incl. this README file)  *
  14. * 2) None of the Copyright texts will be modified.                          *
  15. * 3) None of the files should be stored and/or converted onto environment-  *
  16. *    ally damaging media. (paper listings, faxes, etc...)                   *
  17. *                                                                           *
  18. *                                                                           *
  19. * The Author,                                                               *
  20. *                                                                           *
  21. * Laurence Vanhelsuwé                                                       *
  22. *                                                                           *
  23. * Auroville 26/JAN/94                                                       *
  24. *                                                                           *
  25. *                                                                           *
  26. *****************************************************************************
  27.  
  28. Program Title(s): LIN.EXE, LOUT.EXE, PASS.EXE         (C) L. Vanhelsuwé 1994
  29.  
  30. Author:           Laurence Vanhelsuwé
  31.  
  32.  
  33. 0. Short description:
  34.    ------------------
  35.  
  36.    LIN.EXE  : Log-In command. This command will prompt a user for his or
  37.               her user ID and password and, if the program validates the user,
  38.               it will record the machine access in a logfile.
  39.  
  40.    LOUT.EXE : Log-Out command. Closes the logon session and updates the log
  41.               file.
  42.  
  43.    PASS.EXE : Used by the system operator only, this command allows the listing
  44.               and defining of authorized system users.
  45.  
  46.  
  47. 1. Requirements/Installation:
  48.    --------------------------
  49.  
  50.    These programs require an ANSI compliant text-mode display driver.
  51.  
  52.    On Amigas this is the by default the case. ( smiley follows... 8O )
  53.  
  54.    On IBM PC compatibles, this means you need to have ANSI.SYS installed.
  55.    This is done by adding a line like:
  56.  
  57.       DEVICEHIGH \DOS\ANSI.SYS
  58.  
  59.    to your CONFIG.SYS file.
  60.  
  61.    To install the login/logout system, just copy the three programs into
  62.    any directory which is visited by your command PATH.
  63.  
  64.    Then modify your machine's reboot BATCH file (typically AUTOEXEC.BAT,
  65.    startup-sequence or .login) to call the LIN command as the first command
  66.    the machine executes.
  67.  
  68. 2. How to use it:
  69.    --------------
  70.  
  71.    Simply install the programs as outlined above.
  72.  
  73.    Then define authorized users with the 'PASS' command.
  74.    You will be prompted to enter the 'System operator' password.
  75.    This released version needs the password "AGRCRGA".
  76.  
  77.    To get a list of all currently authorized users of the system, enter the
  78.    system operator's password, immediately followed by the word 'USERS'.
  79.    In this case "AGRCRGAUSERS".
  80.  
  81. 3. Internals:
  82.    ----------
  83.  
  84.    In addition to the three command files, the commands themselves create
  85.    and/or maintain two data files:
  86.  
  87.    On Amigas:
  88.  
  89.       DEVS:USERLOG.DAT
  90.       DEVS:PASSWORDS.DAT
  91.  
  92.    On PCs:
  93.  
  94.       /DOS/USERLOG.DAT
  95.  
  96.       /DOS/PASSWOR.DAT
  97.  
  98.    Therefore this /DOS directory has to exist for these programs to function!
  99.  
  100.    Both data file are plain ASCII files to facilitate viewing.
  101.  
  102.    The USERLOG.DAT file keeps track of all validated machine accesses.
  103.    Only LIN and LOUT modify this file.
  104.    View this file to analyze a machine's usage patterns.
  105.  
  106.    The PASSWOR.DAT file lists the authorized users and their passwords.
  107.    These strings are encoded so it is pretty useless to view this file.
  108.    PASS Encodes user IDs and passwords and LIN automatically decodes them
  109.    to match entered non-encoded strings.
  110.  
  111. 4. Limitations/Warnings:
  112.    ---------------------
  113.  
  114.    If you want to change the 'System Operator's password, I'm afraid you'll
  115.    have to use a generic file editing tool (like NewZap, for example).
  116.    Or you could recompile the program PASS.C with a new password defined.
  117.  
  118.    Both data files are allowed to grow unchecked in the current versions.
  119.    Especially the USERLOG.DAT file grows quickly, so frequent cropping
  120.    or deleting of this file is advised.
  121.  
  122.  
  123. **!! CRASH !!**
  124.  
  125.    Never edit any files manually as this will surely confuse the commands,
  126.    possibly leading to a crash.
  127.  
  128.    Also no error checking is done in case of READ or WRITE errors on disks.
  129.  
  130.  
  131. 5. History:
  132.    --------
  133.  
  134.    The idea for these programs came from a great New Year's Eve party.
  135.  
  136.    LLP Have been in constant use for half a year so far on my machine.
  137.    The log file is just 32K and contains 6 months worth of auditing
  138.    information... not bad.
  139.  
  140. 6. Future:
  141.    -------
  142.  
  143.    Dependent on user's feedback.
  144.  
  145.  
  146. 7. Credits:
  147.    --------
  148.  
  149.    L. Vanhelsuwé                   Jayamoorti (Last School)
  150.    Christinastraat 105
  151.    B-8400 Oostende
  152.    Belgium
  153.